home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
PROGRAM
/
PROTO212.ARJ
/
LISMOI
< prev
next >
Wrap
Text File
|
1992-01-24
|
9KB
|
227 lines
Cette version de l'extracteur de prototypes est un "shareware".
Ce n'est pas une version complète. Solucorp fournis ce programme
uniquement pour évaluation. L'usager a 30 jours pour l'évaluer.
Lorsque l'usager s'enregistre en payant 25$ US ou 30$ canadien,
il reçoit une version complète de l'extracteur ainsi que plusieurs
utilitaires.
L'usager recevra une version DOS, une version UNIX,XENIX
(pour ordinateurs 386/486) and une version SUN SPARC.
L'usager recevra aussi un numéro d'enregistrement lui permettant
de commander n'importe quel révision future de ce produit pour
la modique somme de 10$ (10$ pour chaque révision).
Ce qui suit est une présentation des utilitaires. Le fichier exemple.zip
fournit une description plus complète de l'utilisation de ces programmes.
Solucorp se réserve le droit de modifier la composition de cet ensemble
de programme sans préavis.
-Dircmd: Un "file find" amélioré.
-Make: Un make amélioré.
-Makedep: Un constructeur de dépendances pour makefile.
-Naloc: Un localisateur de déclarations de fonctions.
-Naperm: Un formatteur d'indexs.
-Nadoc: Un formatteur de documentation.
-Nulfct: Elimine certains appels de fonctions dans un source.
Dircmd: Un "file find" amélioré.
Dircmd permet de localiser des fichiers et répertoires à partir
de critères de sélection complexes (date,multiples wildcards,
exclusion, comparaison de répertoires, etc...). De plus,
il permet d'assembler des commandes à partir du nom des fichiers
trouvés.
La commande suivante efface tous les fichiers .obj associés aux
fichiers .c sur un disque.
dircmd -s -e *.c del %p%\%b.obj
Cette commande détruit chaque fichier apparaissant et dans le
répertoire "travail" et le répertoire "archive" et qui ont la même
date de révision et la même dimension. La destruction se fait
dans le répertoire "travail".
dircmd -c+=\archive -e \travail\*.* del %s
Dircmd est essentiel pour la gestion de larges disques dures et
de réseaux.
Make: Un make amélioré.
Le make de Solucorp introduit plusieurs extensions. Il permet
la construction de makefile portable entre DOS et UNIX. Voici
une liste d'extensions par rapport aux make standard.
Voir le fichier makefile dans exemple.zip.
-Elimine la limitation de DOS pour les lignes de commande.
DOS limite une ligne de commande à 126 caractères. Make résout ce
problème de façon quasi invisible.
-Elimine la limite de 640k de DOS.
Make peut soit s'éliminer temporairement de la mémoire ou
déclencher un "window DesqView" séparé, libérant pratiquement
toute la mémoire disponible.
-Traitement conditionnel.
Make supporte un ensemble complet de directive fonctionnant comme
le préprocesseur du compilateur C.
-Projet distribué.
Make peut opérer de façon transparente avec des sources, des
fichiers objets et des librairies disposés dans des répertoires
différents. La disposition exacte est indépendant des règles inscrite
dans les makefile. C'est ce qui permet d'obtenir des makefile
"transportables".
-Syntaxe de définition de macro.
Make supporte la définition de macro à partir de wildcards.
Il supporte l'exclusion.
-Révision dynamique du contenu d'une macro.
Un fois une macro définie, on peut l'utiliser comme telle, ou
avec modifications.
-Gestion automatique des dépendances entre un sources et les
fichiers d'inclusion qu'il référence. Voir l'utilitaire makedep.
-Option touch sélectif.
Un "touch" peut être appliqué sur toutes les cibles qui ne sont
plus à date, seulement si elles sont rendues désuettes par une
dépendance spécifique.
-Option de déverminage permettant d'inspecter l'arbre de décision
du make.
Makedep: Un constructeur de dépendances pour makefile.
Makedep lit une série de fichier source et produit un fichier
"parallèle" qui sera utilisé par make. Ce fichier indique la
dépendances entre un fichier sources et des fichiers d'inclusion.
Vous n'avez plus à réviser le fichier makefile à chaque fois
qu'un fichier d'inclusion est ajouté à un source.
Voir le fichier makefile.dep dans exemple.zip.
Naloc: Un localisateur de déclarations de fonctions.
Naloc localise le source contenant la déclaration d'une fonction
n'importe où dans un projet à plusieurs sources, et plusieurs
répertoires. Se rattache facilement à un éditeur programmable.
Naperm: Un formatteur d'index.
Ce programme produit trois fichier: Un sommaire, un index permutté
et un historique des révisions d'une librairie. Voir le fichier
document.exm dans exemple.zip.
Nadoc: Un formatteur de documentation.
Nadoc produit un document complet sur un système (librairie)
à partir d'un squelette. Vous n'inscrivez que les sections et
sous-sections accompagnées d'une courte description, et
identifiez les fonctions qui font partie de ces sections.
Nadoc produit automatiquement un document à partir de la documentation
extraite des sources. Il crée la table des matières. Il produit
un rapport mentionnant les fonctions qui n'existent plus et
les fonctions qui n'ont pas été classifiées.
Un outils essentiel pour produire du code réutilisable, réutilisé !
Voir document.exm dans exemple.zip.
Nulfct: Elimine certains appels de fonctions dans un source.
Nulfct élimine tous les appels fait à une fonction dans une
série de source. Il produit un fichier temporaire qui sera
compilé, laissant l'original inchangé. Il peut faire le traitement
en parallèle pour plusieurs fonctions. Les fonctions éliminés de
cette façon sont généralement utilisé pour le déverminage.
--------------------------------------------------------------------
Nouvelles options et corrections de proto. Extraits du manuel
protof.man.
--------------------------------------------------------------------
1 Introduction et avertissements
L'extracteur de prototypes automatise et agrémente une
partie du travail d'un programmeur en langage ANSI C et C++
2.0. Il supporte aussi la syntaxe de déclaration de
fonctions K&R.
Une version existe pour MSDOS (PCDOS) version 3 et plus,
pour SCO XENIX version 2.3 (UNIX système V.3.2) et pour SUN
SPARC (Sunos).
Ce manuel s'applique intégralement dans les trois
environnements. Toutefois, le séparateur / a été choisi pour
la spécification de fichiers dans le manuel. La version
MSDOS du logiciel reconnaît le séparateur \ et non pas /.
3.3 Mot-clés ajoutés pour automatiser l'opération de
l'extracteur
Le langage C++ ne permet pas d'extraire les prototypes d'une
façon complètement automatique. Pour sa part le langage C
possède un concept rudimentaire de controle de l'accès.
Sept mot-clés sont interprétés par l'extracteur pour
complètement controler la génération des prototypes à partir
du source.
export C et C++
_export C et C++
PRIVATE C++
PUBLIC C++
PROTECTED C++
STATIC C++
VIRTUAL C++
3.4.3 -b : Mise à jour d'un fichier C++ à partir d'un
fichier .pm
Normalement, proto regroupe tous les prototypes des
fonctions membres d'une classe C++ dans un seul fichier
(voir -m0+,-m1+ et -c+). Ce fichier porte généralement
l'extension ".pm". A partir de ce fichier, les prototypes
des fonctions membres sont distribués dans les fichiers qui
contiennent les déclarations des classes. L'option -b active
cette distribution.
La syntaxe de l'option est:
-bfichier_à_réviser+fichier_pm=fichier_résultat
-bfichier_à_réviser+fichier_pm
-bfichier_à_réviser
-b
Si fichier_résultat n'est pas spécifié, fichier_à_réviser
sera pris comme source et destination. Si fichier_pm n'est
pas spécifié, X.pm sera choisi (X est le nom du répertoire
courant). L'option -b sans arguments sera équivalente à
-bX.hpp+X.pm où -bX.h+X.pm où X est le nom du répertoire
courant. X.h sera utilisé si X.hpp n'existe pas.
L'option -b peut être utilisé plusieurs fois (pour réviser
plusieurs fichier d'inclusion) sur la ligne de commande. Son
action ne sera déclenchée qu'après l'extraction du dernier
prototype.
3.4.15 -o : Nom alternatif pour l'option -m
L'option -m compose le nom des fichiers resultats à partir
du nom du répertoire courant. L'option -o permet de
spécifier un autre nom